/*
 * Copyright (C) 2010 Fores Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package jp.fores.midori.xmlrpc;

import java.sql.Timestamp;
import java.text.ParseException;
import java.util.Date;

import org.xml.sax.SAXException;
import org.xml.sax.SAXParseException;


/**
 * XML-RPCの「dateTime.iso8601」タグを解析するためのクラス。<br>
 * (このクラスはスレッドセーフではありません。)<br>
 * (ライブラリの使用者には公開したくない内部処理用のクラスなので、あえてパッケージスコープにしています。)<br>
 */
class DateTimeIso8601Parser extends AbstractAtomicParser {
	//==========================================================
	//定数

	/**
	 * 日付解析のためのフォーマッター
	 * (「-」や「:」はクライアントによって、あったり無かったりするのでフォーマッターには含めないでおく)
	 */
	private static final SafeDateFormat formatter = new SafeDateFormat("yyyyMMdd'T'HHmmss");


	//==========================================================
	//メソッド

	//_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/_/
	//抽象メソッドの実装

	/**
	 * 文字列を元にして結果のオブジェクトを設定します。<br>
	 *
	 * @param str 文字列
	 * @throws SAXException SAX例外
	 */
	@Override
	protected void setResultFromString(String str) throws SAXException {
		//引数の文字列をまずトリムする
		String trimStr = str.trim();

		//トリムした文字列から「:」と「-」を削除
		String formattedStr = trimStr.replace(":", "").replace("-", "");

		//日付解析の結果のDateを格納する変数
		Date date = null;

		try {
			//加工した文字列をフォーマッタークラスを使って日付として解析する
			date = formatter.parse(formattedStr);
		}
		//日付の解析に失敗した場合
		catch (ParseException e) {
			//捕捉した例外をSAXParseExceptionでラッピングして投げ直す
			throw new SAXParseException("日付の解析に失敗しました。str=" + str, getDocumentLocator(), e);
		}

		//結果のDateの通算ミリ秒を元にして、Timestampクラスのインスタンスを生成し、結果のオブジェクトとして設定する
		//(本当はただのDateクラスでも良いが、Timestampクラスの方がより幅広く使えるため)
		super.setResult(new Timestamp(date.getTime()));
	}
}
